home *** CD-ROM | disk | FTP | other *** search
/ MediaClips: Full Bloom / Aris MediaClips - Full Bloom.iso / pc / alchemy / addendum.doc next >
Text File  |  1992-05-19  |  69KB  |  2,435 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                     Image Alchemy
  15.  
  16.  
  17.  
  18.  
  19.                                      Version 1.6
  20.  
  21.  
  22.  
  23.  
  24.                                       Addendum
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                                Handmade Software, Inc.
  57.  
  58.  
  59.  
  60.  
  61.           Trademarks       Image Alchemy is a trademark of Handmade
  62.                            Software, Inc.
  63.  
  64.                            All other products or services mentioned in this
  65.                            manual are trademarks, registered trademarks,
  66.                            service marks, or registered service marks of
  67.                            their respective companies or organizations.
  68.  
  69.                            Even though they are never mentioned in this
  70.                            document, you should know that Yellow Pages is a
  71.                            registered trademark in the United Kingdom of
  72.                            British Telecommunications plc., and may also be
  73.                            a trademark of various telephone companies
  74.                            around the world.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.                            Copyright (c) 1990-1992 Handmade Software, Inc.
  83.  
  84.                            All Rights Reserved
  85.  
  86.  
  87.  
  88.                            First Printing
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.                            Handmade Software, Inc.
  99.                            15951 Los Gatos Blvd., Suite 17
  100.                            Los Gatos, CA  95032
  101.                            +1 408 358-1292
  102.                            +1 408 358-2694 fax
  103.                            +1 408 356-3297 BBS
  104.  
  105.                            Internet:  hsi@netcom.COM
  106.                            CompuServe:  71330, 3136
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-ii
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.           Contents
  124.           -----------------------------------------------------------------
  125.  
  126.  
  127.  
  128.           Introduction.......................... 1
  129.  
  130.           Image Alchemy for MS-DOS.............. 2
  131.  
  132.           File Formats.......................... 4
  133.              Alpha Microsystems BMP............. 5
  134.              AVHRR.............................. 6
  135.              CALS............................... 8
  136.              Cubicomp PictureMaker.............. 9
  137.              Dr. Halo CUT...................... 10
  138.              First Publisher ART............... 11
  139.              GEM VDI Image File................ 12
  140.              GOES.............................. 14
  141.              IBM Picture Maker................. 16
  142.              PDS............................... 17
  143.              RIX............................... 18
  144.              SGI............................... 19
  145.              SPOT Image........................ 20
  146.              Sun Raster........................ 21
  147.              Windows Bitmap.................... 22
  148.              XPM............................... 25
  149.  
  150.           Colour and Palette Options........... 26
  151.              Dither............................ 27
  152.              Gamma correction.................. 29
  153.              Negate............................ 31
  154.              Spiff............................. 32
  155.  
  156.           Viewing Options (MS-DOS Only)........ 34
  157.              View Image in 15 Bit Mode......... 35
  158.              View Scaled Image in 15 Bit Mode.. 36
  159.  
  160.           Answers to Frequently Asked Questions 37
  161.  
  162.           Version History...................... 38
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-iii
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.           Introduction to this Addendum
  184.           -----------------------------------------------------------------
  185.  
  186.  
  187.           Why an Addendum? This addendum covers changes in Image Alchemy
  188.                            that were made after the manual was printed.
  189.                            These changes consist of new file formats,
  190.                            changes to existing file formats, additions and
  191.                            changes in colouring options, and changes in the
  192.                            viewing options (for the MS-DOS version only).
  193.  
  194.                            Where changes have been made, this manual covers
  195.                            the options in their entirety, saving you the
  196.                            trouble of having to look at both manuals for a
  197.                            single option.
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-1
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.           Image Alchemy for MS-DOS
  240.           -----------------------------------------------------------------
  241.  
  242.  
  243.           Use of extended  If there is enough extended or expanded memory
  244.           and expanded     available, Alchemy will use it instead of the
  245.           memory           temporary file it would otherwise use during
  246.                            some conversions.  To use extended memory you
  247.                            must have an XMS driver installed in the
  248.                            config.sys file (such as HIMEM.SYS or 386MAX).
  249.                            To use expanded memory you must have a LIM 3.2
  250.                            or LIM 4.0 expanded memory driver installed
  251.                            (such as EMM386, QEMM, or 386MAX).
  252.  
  253.                            It is possible for there to be some
  254.                            incompatibility when using some older drivers
  255.                            and/or TSRs which also use extended memory.
  256.                            Therefore Alchemy's use of extended/expanded
  257.                            memory can be disabled.  To disable use of
  258.                            extended and expanded memory, set an environment
  259.                            variable called 'alchemy' to 'x' (type "set
  260.                            alchemy=x" at the DOS prompt).
  261.  
  262.                            Note that the availability of extended or
  263.                            expanded memory will not allow you to convert
  264.                            larger images, just speed up conversions.  We
  265.                            also have a 386 version of Image Alchemy, which
  266.                            will allow 80386 and 80486 users to make use of
  267.                            the linear addressing space of those processors
  268.                            along with virtual memory to convert images of
  269.                            up to 32000 x 32000 (assuming you have enough
  270.                            disk space).  Please contact us if you are
  271.                            running out of memory and are interested in
  272.                            upgrading to Alchemy/386.
  273.  
  274.           Checking for     Alchemy will normally check to determine if
  275.           8514/A boards    there is an 8514/A board installed in the
  276.                            computer when viewing images.  However, this can
  277.                            cause problems with some network boards, as they
  278.                            use the same I/O addresses that 8514/A boards
  279.                            use.  To disable 8514/A checking, set the
  280.                            environment variable called 'alchemy' to '8'
  281.                            (type "set alchemy=8" at the DOS prompt).
  282.  
  283.                            Note that this can be combined with other
  284.                            options; for example, to disable both 8514/A
  285.                            checking and extended/expanded memory usage, use
  286.                            "set alchemy=8x".
  287.  
  288.  
  289.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-2
  290.  
  291.  
  292.  
  293.           Limiting maximum Alchemy will automatically choose the lowest
  294.           display          resolution which will fit the entire image when
  295.           resolution       viewing images without specifying a display
  296.                            resolution with a VESA compatible VGA board.
  297.                            However, depending on the monitor and VGA board
  298.                            combination you have, this can be bad since the
  299.                            monitor may not support all the resolutions the
  300.                            SVGA board does.  Therefore the environment
  301.                            variable 'alchemy' may now be set to indicate
  302.                            the maximum display resolution which Alchemy
  303.                            should use.  Set the alchemy variable to the
  304.                            highest horizontal resolution which your monitor
  305.                            is capable of.  Valid values are 1280, 1024,
  306.                            800, and 640.  For example, "set alchemy=800",
  307.                            if your monitor only supports 640x480 and
  308.                            800x600 mode.
  309.  
  310.                            Note that this can be combined with other
  311.                            options; for example, to disable 8514/A
  312.                            checking, disable extended/expanded memory
  313.                            usage, and limit the viewing resolution to
  314.                            640x480 use "set alchemy=8x640".
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-3
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.           Output Options
  356.           -----------------------------------------------------------------
  357.  
  358.  
  359.           Introduction     Since the release of v1.5 several new output
  360.                            formats have been added and several existing
  361.                            output formats have had compression modes or
  362.                            output options added.
  363.  
  364.                            Formats which have had options added:
  365.                               GEM VDI        Sun Raster
  366.                               SGI            Windows BMP
  367.  
  368.                            New formats:
  369.                               Alpha Microsystems BMP
  370.                               AVHRR
  371.                               CALS
  372.                               Cubicomp PictureMaker
  373.                               Dr. Halo CUT
  374.                               First Publisher ART
  375.                               GOES
  376.                               IBM Picture Maker
  377.                               PDS
  378.                               RIX
  379.                               SPOT Image
  380.                               XPM
  381.  
  382.                            In addition to those changes, the following
  383.                            formats are now optimally compressed when they
  384.                            are written by Image Alchemy; this can result in
  385.                            a significant savings in disk space for certain
  386.                            images:
  387.                               WPG
  388.                               Utah Raster Toolkit (RLE)
  389.                               GEM IMG
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-4
  406.  
  407.  
  408.  
  409.           Alpha Microsystems BMP                                         -M
  410.  
  411.  
  412.                            Alpha Microsystems BMP files are used by Alpha
  413.                            Microsystems.
  414.  
  415.           Syntax           -M compressionType
  416.  
  417.           Parameter        compressionType:
  418.                                 0:None
  419.                                 1:Packed
  420.                            The default is None.
  421.  
  422.           Extension        .bmp
  423.  
  424.           Creator          Alpha Microsystems.
  425.  
  426.           Used by          Alpha Microsystems workstations.
  427.  
  428.           Variations       Reads and writes 1, 4, 8, and 24 bit unpacked
  429.                            and packed (run-length encoded) RGB images.
  430.  
  431.           Limitations      Reading and writing HLS images is not supported.
  432.  
  433.           Comments         When reading an image without a palette Alchemy
  434.                            will generate a gray-scale palette.
  435.  
  436.           Examples         Convert the GIF file, bigpict.gif, to an
  437.                            uncompressed Alpha Microsystems BMP file:
  438.  
  439.                                 alchemy bigpict.gif -M
  440.  
  441.                            Do the same thing, but force a 24 bit image, and
  442.                            compress the image:
  443.  
  444.                                 alchemy bigpict.gif -M1 -24
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-5
  464.  
  465.  
  466.  
  467.           AVHRR                                                         --R
  468.  
  469.  
  470.                            AVHRR files are used for satellite image data.
  471.  
  472.           Syntax           --R outputType
  473.  
  474.           Parameter        outputType
  475.                                 1:IDIDAS Uncompressed
  476.                                 2:IDIDAS Compressed type 1
  477.                            The default is 1 (IDIDAS Uncompressed).
  478.  
  479.           Extension        .sst
  480.  
  481.           Creator          National Oceanic and Atmospheric Administration
  482.                            (NOAA)
  483.                            National Environmental Satellite Data
  484.                            Information Service (NESDIS)
  485.  
  486.           Used by          IDIDAS
  487.                            SSTMAP
  488.                            IMGMAP
  489.  
  490.           Variations       Reads 8 and 11 bits per pixel IDIDAS AVHRR
  491.                            files.
  492.  
  493.                            Writes 11 bits per pixel IDIDAS AVHRR files.
  494.  
  495.           Limitations      Level 1B AVHRR files will be supported at a
  496.                            later date; please contact us for more
  497.                            information.
  498.  
  499.                            Alchemy discards all but the top 8 bits when
  500.                            reading 11 bit AVHRR files.  When writing, the
  501.                            bottom 3 bits are padded with 0.
  502.  
  503.                            Any graphics information is discarded when
  504.                            reading the file.
  505.  
  506.                            Since AVHRR images are always grayscale, Alchemy
  507.                            assumes the use of the -b and -8 options when
  508.                            writing a AVHRR file.
  509.  
  510.           Comments         AVHRR images contain a lot of information which
  511.                            is not part of the image data.  This information
  512.                            includes the time and date the image was
  513.                            captured, the satellite which captured the
  514.                            image, the type of instrumentation used, etc.
  515.                            When reading AVHRR images this information is
  516.                            discarded; when writing AVHRR images 0 is
  517.                            written for all values for which data is
  518.                            unavailable.
  519.  
  520.  
  521.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-6
  522.  
  523.  
  524.  
  525.           Examples         Convert the GOES file, florida.goe, to an
  526.                            uncompressed IDIDAS AVHRR file:
  527.  
  528.                                 alchemy --R1 florida.goe
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-7
  580.  
  581.  
  582.  
  583.           CALS                                                          --c
  584.  
  585.  
  586.                            Computer-aided Acquisition and Logistics Support
  587.                            (CALS) files are black and white images used by
  588.                            the US Government as part of their transition to
  589.                            electronic media.
  590.  
  591.           Syntax           --c
  592.  
  593.           Extension        .cal
  594.  
  595.           Creator          Defense Logistics Agency (DLA)
  596.  
  597.           Used by          Department of Defense (DoD)
  598.  
  599.           Variations       Reads and writes type 1 (Group 4 raster) CALS
  600.                            images.
  601.  
  602.           Limitations      Document labels, such as document ID and figure
  603.                            ID, are ignored.
  604.  
  605.           Comments         Since CALS files are always black and white,
  606.                            Alchemy assumes the use of the -b, -8, and -c2
  607.                            options when writing CALS files.
  608.  
  609.                            CALS images are Fax Group IV compressed and are
  610.                            therefore a good way of storing black and white
  611.                            line drawings and scans.
  612.  
  613.           Examples         Convert the TIFF file page1.tif to a CALS file:
  614.  
  615.                                 alchemy page1.tif --c
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-8
  638.  
  639.  
  640.  
  641.           Cubicomp PictureMaker                                         --P
  642.  
  643.  
  644.                            Cubicomp PictureMaker files are used in
  645.                            broadcast-quality three dimensional modelling
  646.                            and animation.
  647.  
  648.           Syntax           --P
  649.  
  650.           Extension        .r8 (Red channel image data)
  651.                            .g8 (Green channel image data)
  652.                            .b8 (Blue channel image data)
  653.                            .a8 (Alpha channel image data [optional)
  654.  
  655.           Creator          Cubicomp Corp.
  656.  
  657.           Used by          Cubicomp PictureMaker
  658.  
  659.           Variations       Reads and writes 24 bit true colour images.
  660.  
  661.           Limitations      If an alpha channel exists, it will be ignored.
  662.  
  663.                            8-bit paletted PictureMaker files are
  664.                            unsupported.
  665.  
  666.           Comments         This format is not the same as IBM Picture
  667.                            Maker.
  668.  
  669.                            PictureMaker images have either three or four
  670.                            separate files per image: a red, green, blue,
  671.                            and optional alpha channel.  You specify the
  672.                            name of the .r8 file and Alchemy automatically
  673.                            generates the name of the .g8 and .b8 files
  674.  
  675.                            When writing a PictureMaker file Alchemy will
  676.                            overwrite, without warning, existing .g8 and .b8
  677.                            files.
  678.  
  679.           Examples         Convert the 24-bit JPEG image stones.jpg to
  680.                            PictureMaker files:
  681.  
  682.                                 alchemy --P stones.jpg
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-9
  696.  
  697.  
  698.  
  699.           Dr. Halo CUT                                                  --C
  700.  
  701.  
  702.                            Dr. Halo CUT files are used by various MS-DOS
  703.                            based paint software.
  704.  
  705.           Syntax           --C
  706.  
  707.           Extension        .pal (palette and header)
  708.                            .cut (pixel data)
  709.  
  710.           Creator          Media Cybernetics
  711.  
  712.           Used by          Dr. HALO III Paint Package
  713.                            HALO Desktop Imager
  714.  
  715.           Variations       8 bits per pixel
  716.  
  717.           Comments         Dr. Halo CUT images are actually two files.  You
  718.                            specify the name of the .cut file and Alchemy
  719.                            automatically generates the name of the .pal
  720.                            file.
  721.  
  722.                            When writing a Dr. Halo CUT file Alchemy will
  723.                            overwrite, without warning, existing .pal files.
  724.  
  725.           Examples         Convert the image test.pcx to a Dr. Halo CUT
  726.                            file:
  727.  
  728.                                 alchemy test.pcx --C
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-10
  754.  
  755.  
  756.  
  757.           First Publisher ART                                           --F
  758.  
  759.  
  760.                            First Publisher ART files are black and white
  761.                            images used as clip art by First Publisher.
  762.  
  763.           Syntax           --F
  764.  
  765.           Extension        .art
  766.  
  767.           Creator          Software Publishing Corp.
  768.  
  769.           Used by          First Publisher
  770.  
  771.           Variations       Black and white, 1 bit per pixel.
  772.  
  773.           Comments         Since ART files are always black and white, 1
  774.                            bit per pixel, Alchemy assumes use of the -c2
  775.                            and -b options when writing them.
  776.  
  777.           Examples         Convert the image scan.pcx to a First Publisher
  778.                            ART file:
  779.  
  780.                                 alchemy scan.pcx --F
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-11
  812.  
  813.  
  814.  
  815.           GEM VDI Image File                                            --g
  816.  
  817.  
  818.                            VDI files are files that were developed by
  819.                            Digital Research to use with GEM.
  820.  
  821.           Syntax           --g
  822.  
  823.           Extension        .img
  824.  
  825.           Creator          Digital Research Inc.
  826.  
  827.           Used by          GEM
  828.  
  829.           Variations       Reads 1-8 bit grayscale and 3 and 4 bit colour
  830.                            files.
  831.  
  832.                            Writes 1, 3, and 4 bit grayscale and 3 and 4 bit
  833.                            colour files.
  834.  
  835.           Limitations      The support for colour and multiple bit
  836.                            grayscale GEM files is not very universal.
  837.                            Therefore make sure the application you are
  838.                            using to read the GEM files can in fact handle
  839.                            them.
  840.  
  841.                            Alchemy defaults to writing out a 1 bit, black
  842.                            and white GEM file.  You can explicitly force a
  843.                            3 plane colour file by use of the -c8 option and
  844.                            a 4 plane colour file by use of the -c16 option
  845.                            (you may add a -b to write a grayscale file
  846.                            instead of a colour file).
  847.  
  848.           Comments         Because colour GEM files have only 3 or 4 bits
  849.                            of information and no palette support the
  850.                            quality is generally not very good for scanned
  851.                            images.  The GEM format seems to have been
  852.                            designed for line drawings.
  853.  
  854.  
  855.  
  856.           Examples         Convert the image scan.pcx to a black and white
  857.                            GEM file:
  858.  
  859.                                 alchemy scan.pcx --g
  860.  
  861.                            Convert the image bigscan.tga to a 640x480, 8
  862.                            colour GEM file, using nearest neighbor scaling
  863.                            and type 2 dithering:
  864.  
  865.                                 alchemy -c 8 --g bigscan.tga -X640
  866.                                   -Y480 -d2
  867.  
  868.  
  869.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-12
  870.  
  871.  
  872.  
  873.                            Do the same thing but write an 8 shade grayscale
  874.                            file with no dithering:
  875.  
  876.                                 alchemy -c 8 --g bigscan.tga -X640
  877.                                   -Y480 -d -b
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-13
  928.  
  929.  
  930.  
  931.           GOES                                                          --G
  932.  
  933.  
  934.                            GOES files are used for satellite image data.
  935.  
  936.           Syntax           --G goesType
  937.  
  938.           Parameter        goesType:
  939.                                 0:GARS format
  940.                                 1:McIDAS format
  941.                            The default is 0 (GARS format).
  942.  
  943.           Extension        .goe
  944.  
  945.           Creator          The University of Wisconsin
  946.                            National Oceanic and Atmospheric Administration
  947.                            (NOAA)
  948.                            National Environmental Satellite Data
  949.                            Information Service (NESDIS)
  950.  
  951.           Used by          Various satellite image processing software,
  952.                            including the McIDAS system.
  953.  
  954.           Variations       Reads 8, 16, and 32 bits per pixel GOES images.
  955.  
  956.                            Writes 8 bits per pixel images.
  957.  
  958.           Limitations      When reading 16 and 32 bit images Alchemy
  959.                            discards all but the top 8 bits of data.
  960.  
  961.                            Alchemy discards any calibration data and level
  962.                            maps when reading images.
  963.  
  964.                            Because of difficulty in getting a sufficient
  965.                            number of test images in the GOES format
  966.                            (especially the PUT format) reading GOES images
  967.                            has not been thoroughly tested.  If you have any
  968.                            GOES images  which Alchemy does not read
  969.                            correctly please contact us.
  970.  
  971.           Comments         The GARS format is a 7680 bytes per block,
  972.                            Motorola byte-order, EBCDIC format; the MCIDAS
  973.                            format is a continuous data, Intel byte-order,
  974.                            ASCII format.
  975.  
  976.                            Since GOES images are always grayscale, Alchemy
  977.                            assumes the use of the -b and -8 options when
  978.                            writing a GOES file.
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-14
  986.  
  987.  
  988.  
  989.                            GOES images contain a lot of information which
  990.                            is not part of the image data.  This information
  991.                            includes the time and date the image was
  992.                            captured, the satellite which captured the
  993.                            image, the type of instrumentation used, etc.
  994.                            When reading a GOES image this information is
  995.                            discarded; when writing a GOES images 0 is
  996.                            written for all values for which data is
  997.                            unavailable.
  998.  
  999.           Examples         Convert the Erdas file, florida.gis, into a GOES
  1000.                            GARS image:
  1001.  
  1002.                                 alchemy --G0 florida.gis
  1003.  
  1004.                            Do the same thing, but write out a GOES McIDAS
  1005.                            image:
  1006.  
  1007.                                 alchemy --G1 florida.gis
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-15
  1044.  
  1045.  
  1046.  
  1047.           IBM Picture Maker                                             --i
  1048.  
  1049.  
  1050.                            IBM Picture Maker files are used by IBM
  1051.                            presentation software.
  1052.  
  1053.           Syntax           --i
  1054.  
  1055.           Extension        .pic
  1056.  
  1057.           Creator          IBM
  1058.  
  1059.           Used by          IBM Storyboard Live!
  1060.  
  1061.           Variations       Reads and writes 256 colour Picture Maker files.
  1062.  
  1063.           Limitations      16 colour Picture Maker files are not supported.
  1064.                            Picture Maker images can not be larger than
  1065.                            640x480.
  1066.  
  1067.           Comments         This is not the same format as Cubicomp
  1068.                            PictureMaker.
  1069.  
  1070.                            256 colour Picture Maker files may be either
  1071.                            320x200 or 640x480.  Image Alchemy will write
  1072.                            the smallest variation that the image will fit
  1073.                            in, with the image centered; the borders will be
  1074.                            filled with colour 0.
  1075.  
  1076.           Examples         Convert the PCX file, giraffe.pcx, into an IBM
  1077.                            Picture Maker file:
  1078.  
  1079.                                 alchemy --i giraffe.pcx
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-16
  1102.  
  1103.  
  1104.  
  1105.           PDS                                                           --p
  1106.  
  1107.  
  1108.                            PDS labeled images are used by NASA for
  1109.                            planetary images.
  1110.  
  1111.           Syntax           --p
  1112.  
  1113.           Extensions       .ibg
  1114.                            .imq
  1115.  
  1116.           Creator          NASA
  1117.  
  1118.           Used by          NASA distributes collections of planetary images
  1119.                            on CD-ROM in PDS format.
  1120.  
  1121.           Variations       Reads 1 and 8 bit uncompressed and 8 bit first
  1122.                            difference Huffman compressed files.
  1123.  
  1124.                            Writes 8 bit gray-scale uncompressed PDS files.
  1125.  
  1126.           Limitations      PDS images must begin with either an
  1127.                            "SFDU_LABEL" or a "FILE_TYPE" record for Alchemy
  1128.                            to be able to identify it.
  1129.  
  1130.                            Occasionally a PDS labeled image has a palette.
  1131.                            There doesn't seem to be any standard format for
  1132.                            the palette; Image Alchemy handles the palettes
  1133.                            we've encountered.
  1134.  
  1135.                            Any portions of the PDS labels not required to
  1136.                            extract the image, such as longitude and
  1137.                            latitude, are ignored.
  1138.  
  1139.           Comments         Since Image Alchemy only writes gray-scale PDS
  1140.                            images, Alchemy assumes the use of the -b option
  1141.                            when writing PDS files.
  1142.  
  1143.                            Some PDS images actually consist of two files, a
  1144.                            label file and a data file.  To read that type
  1145.                            image you should use the name of the label file
  1146.                            and Alchemy will find the data file.
  1147.  
  1148.           Examples         Convert the GOES file, phoenix.goe, into a PDS
  1149.                            labeled image:
  1150.  
  1151.                                 alchemy --p phoenix.goe
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-17
  1160.  
  1161.  
  1162.  
  1163.           RIX                                                            -R
  1164.  
  1165.  
  1166.                            RIX files are colour files developed by ColoRIX
  1167.                            to use with their paint software.
  1168.  
  1169.           Syntax           -R
  1170.  
  1171.           Extension        .scx
  1172.                            .rix
  1173.  
  1174.           Creator          RIX Softworks, Inc.
  1175.  
  1176.           Used by          ColoRIX software
  1177.  
  1178.           Variations       Reads and writes Type 0 (8 bits per pixel) and
  1179.                            Type 4 (4 bits per pixel) images.
  1180.  
  1181.           Limitations      We would like to add support for Type 1 and Type
  1182.                            2 images but we haven't been able to find any;
  1183.                            if you have some please contact us.
  1184.  
  1185.           Comments         A type 0 file will be written if there are more
  1186.                            than 16 colours in the image; otherwise a type 4
  1187.                            file will be written.
  1188.  
  1189.           Examples         Convert the file test.gif to a RIX file:
  1190.  
  1191.                                 alchemy test.gif -R
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-18
  1218.  
  1219.  
  1220.  
  1221.           Silicon Graphics Image (SGI)                                   -n
  1222.  
  1223.  
  1224.                            Silicon Graphics Image files are used by Silicon
  1225.                            Graphics workstations.
  1226.  
  1227.           Syntax           -n compressionType
  1228.  
  1229.           Parameter        compressionType:
  1230.                                 0:Verbatim (uncompressed)
  1231.                                 1:RLE compressed
  1232.                            The default is 0 (Verbatim).
  1233.  
  1234.           Extension        .sgi
  1235.  
  1236.           Creator          Silicon Graphics, Inc.
  1237.  
  1238.           Used by          Silicon Graphics workstations.
  1239.  
  1240.           Variations       Reads and writes 1, 8 (gray-scale), and 24 bit
  1241.                            verbatim (uncompressed) and RLE files.
  1242.  
  1243.           Comments         Only gray-scale images may be 8 bit files.
  1244.                            Alchemy will automatically switch to 24 bit mode
  1245.                            when writing a colour image.
  1246.  
  1247.           Example          Convert the Sun raster file sun.im8 to a SGI
  1248.                            file called sgiout:
  1249.  
  1250.                                 alchemy -n sun.im8 sgiout -.
  1251.  
  1252.                            Do the same thing, but write out a RLE
  1253.                            compressed SGI file:
  1254.  
  1255.                                 alchemy -n1 sun.im8 sgiout -.
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-19
  1276.  
  1277.  
  1278.  
  1279.           SPOT Image                                                    --S
  1280.  
  1281.  
  1282.                            SPOT Image GIS data files are high-resolution
  1283.                            satellite images produced by SPOT Image
  1284.                            Corporation.
  1285.  
  1286.           Syntax           --S
  1287.  
  1288.           Extensions       .hdr (For image header information)
  1289.                            .bil (For pixel data)
  1290.                            .clr (For palette data [optional])
  1291.  
  1292.           Creator          SPOT Image Corp.
  1293.  
  1294.           Used by          SPOT Image Corp.
  1295.  
  1296.           Variations       8 bits per pixel
  1297.  
  1298.           Limitations      Only 1 band, GIS images are supported; if you
  1299.                            have any other type of SPOT GIS images we would
  1300.                            be interested in supporting them, please contact
  1301.                            us.
  1302.  
  1303.           Comments         SPOT Image images are actually three files.  You
  1304.                            specify the name of the .hdr file and Alchemy
  1305.                            automatically generates the name of the .bil and
  1306.                            .clr files.
  1307.  
  1308.                            If no palette file (.clr file) exists Alchemy
  1309.                            will assume the image is grayscale.
  1310.  
  1311.                            There may also be a statistics file with a .stx
  1312.                            extension, but Alchemy ignores this file.
  1313.  
  1314.                            When writing a SPOT file Alchemy will overwrite,
  1315.                            without warning, existing .bil and .clr files.
  1316.  
  1317.           Examples         Convert the Erdas file, phoenix.lan, to a SPOT
  1318.                            Image file:
  1319.  
  1320.                                 alchemy --S phoenix.lan
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-20
  1334.  
  1335.  
  1336.  
  1337.           Sun Raster                                                     -s
  1338.  
  1339.  
  1340.                            Sun Raster files are used by Sun Microsystems
  1341.                            workstations.
  1342.  
  1343.           Syntax           -s compressionType
  1344.  
  1345.           Parameter        compressionType:
  1346.                                 0:None
  1347.                                 1:Run length compression
  1348.                            The default is None.
  1349.  
  1350.           Extensions       .rast
  1351.                            .ras
  1352.                            .im
  1353.                            .im1
  1354.                            .im8
  1355.                            .im24
  1356.                            .im32
  1357.  
  1358.           Creator          Sun Microsystems, Inc.
  1359.  
  1360.           Used by          Sun workstations
  1361.  
  1362.           Variations       Reads 1, 8, 24, and 32 bit Standard, BGR, RGB,
  1363.                            and Byte Encoded (RLE) files.
  1364.  
  1365.                            Writes 1, 8, 24, and 32 bit Standard files, and
  1366.                            1 and 8 bit Byte Encoded (RLE) files.
  1367.  
  1368.           Limitations      For a short time a version of the PBM toolkit
  1369.                            wrote Sun Raster files which had the wrong RGB
  1370.                            order.  Unfortunately there seem to be many
  1371.                            images which were generated with this incorrect
  1372.                            RGB order.  Please be aware that Alchemy's Sun
  1373.                            Raster reading and writing capability has been
  1374.                            extensively tested and compared to various other
  1375.                            tools; the RGB order we use is correct.
  1376.  
  1377.           Comments         Sun Raster files are normally not compressed and
  1378.                            so take up lots of disk space.
  1379.  
  1380.                            There is no standard extension for Sun Raster
  1381.                            files; the extensions that Alchemy uses seem to
  1382.                            be the most common.
  1383.  
  1384.           Example          Convert the SGI file sgiout to a sun raster file
  1385.                            called sun.im8:
  1386.  
  1387.                                 alchemy -s sgiout sun.im8
  1388.  
  1389.  
  1390.  
  1391.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-21
  1392.  
  1393.  
  1394.  
  1395.           Windows Bitmap (BMP)                                           -w
  1396.  
  1397.  
  1398.                            Windows BMP files are used by Microsoft Windows.
  1399.  
  1400.           Syntax           -w compressionType
  1401.  
  1402.           Parameter        compressionType:
  1403.                                 0:None
  1404.                                 1:RLE
  1405.                                 10:Write an ICOn file
  1406.                            The default is none.
  1407.  
  1408.           Extension        .bmp
  1409.  
  1410.           Creator          Microsoft Corp.
  1411.  
  1412.           Used by          Microsoft Windows
  1413.  
  1414.           Variations       Reads 1, 4, 8, and 24 bit RGB (raw), RLE4, and
  1415.                            RLE8 files.
  1416.  
  1417.                            Writes 1, 4, 8, and 24 bit RGB (raw), RLE4, and
  1418.                            RLE8 files.
  1419.  
  1420.           Limitations      Several of the programs which claim to read and
  1421.                            write RLE files do not do so correctly; we do
  1422.                            not recommend writing RLE files unless you have
  1423.                            verified that they work with your intended
  1424.                            application.
  1425.  
  1426.           Comments         Microsoft supplied Windows utilities cannot read
  1427.                            nor write RLE4 or RLE8 files.
  1428.  
  1429.                            If you are converting an image to use as
  1430.                            wallpaper on a 16 colour display you will want
  1431.                            to match the palette of the output image to one
  1432.                            of the existing 16 colour BMP images supplied
  1433.                            with Windows (chess.bmp, for example).  If you
  1434.                            do not do this the wallpaper will not be loaded
  1435.                            correctly.  See the example section below.
  1436.  
  1437.                            If you are converting an image to use as
  1438.                            wallpaper on a 256 colour Windows 3.1 display
  1439.                            you will want to reserve the first 8 colours.
  1440.                            Use the -c 256 8 option to do this (see below
  1441.                            for an example).  This will force the first 8
  1442.                            colours of the palette to be the standard
  1443.                            Windows colours.
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-22
  1450.  
  1451.  
  1452.  
  1453.                            If you are writing a Windows icon (.ico) file
  1454.                            you must scale the image to a width and a height
  1455.                            of 16, 32, or 64 pixels (32 being the best
  1456.                            choice, since Windows displays all icons as
  1457.                            32x32).  Also, Windows seems to remap all icons
  1458.                            to the standard 16 colours, so the best results
  1459.                            can be obtained if you match the palette of your
  1460.                            icons to an existing icon (see the -f option).
  1461.                            If you don't have any other icons you can also
  1462.                            match to one of the 16 colour wallpaper files
  1463.                            supplied with Windows.
  1464.  
  1465.                            Alchemy can write an image with a palette
  1466.                            identity file as specified in the Microsoft
  1467.                            Multimedia Development Kit.  These images
  1468.                            provide for quicker bitmap loading when used
  1469.                            with the Multimedia Extensions.  A palette
  1470.                            identity file has the first and last 10 palette
  1471.                            entries reserved for 20 system defined colours.
  1472.                            Alchemy will write such an image if you specify
  1473.                            -c 246 10 as part of the command line.  Note
  1474.                            that ordinarily this would produce a file which
  1475.                            has 246 palette entries, but in this special
  1476.                            case the file will have 256 palette entries (20
  1477.                            fixed by the Windows specifications and 236
  1478.                            chosen by Alchemy).  Note that you can also
  1479.                            specify a number smaller than 246, but the
  1480.                            palette will always have 256 colours (since the
  1481.                            last 10 have to occupy positions 246 through
  1482.                            255)
  1483.  
  1484.           Related options  -c   Specify number of colours
  1485.                            -f   Match to existing palette
  1486.  
  1487.           Examples         Convert the image test.gif to a Windows BMP
  1488.                            file:
  1489.  
  1490.                                 alchemy test.gif -w
  1491.  
  1492.                            Convert the image test.gif to a 16 colour
  1493.                            Windows BMP file to be used as wallpaper (the
  1494.                            file chess.bmp is supplied with Windows 3.0
  1495.                            (substitute leaves.bmp when using Windows 3.1);
  1496.                            this example assumes that it is in the current
  1497.                            directory):
  1498.  
  1499.                                 alchemy test.gif -f chess.bmp -w
  1500.  
  1501.                            Convert the image test.gif to a 256 colour
  1502.                            Windows BMP file to be used as wallpaper with
  1503.                            Windows 3.1:
  1504.  
  1505.                                 alchemy test.gif -c256 8 -w
  1506.  
  1507.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-23
  1508.  
  1509.  
  1510.  
  1511.                            Convert the image test.gif to an icon file for
  1512.                            use with Windows 3.1:
  1513.  
  1514.                                 alchemy test.gif -Xb32 -Yb32 -w 10 -f
  1515.                                 leaves.bmp
  1516.  
  1517.                            Convert the image test.gif to an identity
  1518.                            palette BMP file:
  1519.  
  1520.                                 alchemy test.gif -w -c 246 10
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-24
  1566.  
  1567.  
  1568.  
  1569.           XPM                                                           --x
  1570.  
  1571.  
  1572.                            XPM files are used by the X Windowing System.
  1573.                            XPM files are C source code files which can be
  1574.                            read and written by various X utilities and are
  1575.                            designed to be included in C source code for use
  1576.                            as icons and other bit-mapped graphic images.
  1577.  
  1578.           Syntax           --x
  1579.  
  1580.           Extensions       .xpm
  1581.                            .pm
  1582.  
  1583.           Creator          MIT
  1584.  
  1585.           Used by          The X Windowing system
  1586.  
  1587.           Variations       8 bits per pixel
  1588.  
  1589.           Limitations      Because .xpm files are actually C source code
  1590.                            files there can be many variations of .xpm
  1591.                            files.  Since adding a C preprocessor to Alchemy
  1592.                            to handle all the theoretically allowable .xpm
  1593.                            files is impractical we have instead designed
  1594.                            Alchemy to interchange .xpm files with the PBM
  1595.                            utilities and the X supplied utilities, and to
  1596.                            read the sample .xpm files from IBM.  If you run
  1597.                            across any .xpm files which Alchemy can not read
  1598.                            please contact us.
  1599.  
  1600.                            Some XPM files contain colour names instead of
  1601.                            colour values for some of the colours.  The
  1602.                            conversion table of these names into values is
  1603.                            in the file rgb.txt.  Alchemy will look for this
  1604.                            table in the current directory and automatically
  1605.                            use it to convert XPM files if it is needed.
  1606.                            Therefore you may have to copy the rgb.txt file
  1607.                            to the current directory (its location is system
  1608.                            dependent; ask you system administrator if you
  1609.                            need help finding it).
  1610.  
  1611.           Comments         When writing an XPM file with less than 27
  1612.                            colours Alchemy writes 1 character XPM files,
  1613.                            otherwise Alchemy writes 2 character XPM files.
  1614.  
  1615.           Example          Convert the file picture.im32 to an XPM file
  1616.                            using high quality scaling and preserving the
  1617.                            aspect ratio:
  1618.  
  1619.                                 alchemy --x -Xb64 -+ picture.im32
  1620.  
  1621.  
  1622.  
  1623.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-25
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.           Colour and Palette Options
  1632.           -----------------------------------------------------------------
  1633.  
  1634.  
  1635.           Introduction     Since version 1.5 we have added two options to
  1636.                            the colour and palette section:
  1637.  
  1638.                                 Image Negation
  1639.                                 Gamma Correction
  1640.  
  1641.  
  1642.  
  1643.                            Also the options for these options has been
  1644.                            expanded:
  1645.  
  1646.                                 Dithering
  1647.                                 Spiffing
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-26
  1682.  
  1683.  
  1684.  
  1685.           Dither                                                         -d
  1686.  
  1687.  
  1688.           Purpose          Specifies the type of dithering to apply to the
  1689.                            image.
  1690.  
  1691.           Syntax           -d[s] ditherType [perturbation]
  1692.  
  1693.           Parameters       If the -d is immediately followed by an 's',
  1694.                            then a serpentine raster is used.
  1695.  
  1696.                            ditherType can be:
  1697.                                 0:None
  1698.                                 1:Floyd-Steinberg
  1699.                                 2:Stucki
  1700.                                 3:Jarvis, Judice, & Ninke
  1701.                                 4:Stevenson and Arce
  1702.                                 5:Sierra Lite
  1703.                                 20:Halftone (clustered dot)
  1704.                                 21:Bayer (dispersed dot)
  1705.                            The default is Floyd-Steinberg.
  1706.  
  1707.                            perturbation
  1708.                                 0 through 127
  1709.                            The default is 0.
  1710.  
  1711.           Comments         Dithering is used to reduce colour banding in an
  1712.                            image caused by the palette not having a perfect
  1713.                            match for every colour in the image.
  1714.  
  1715.                            Types 1 through 5 are all error-diffusion
  1716.                            dithers.  Types 1 and 5 are the fastest of the
  1717.                            diffusion dithers, and they usually look the
  1718.                            best on low resolution devices like CRTs.  Types
  1719.                            2, 3, and 4 all tend to cause an image to appear
  1720.                            more grainy on low resolution output devices
  1721.                            (such as CRTs).  However, they produce better
  1722.                            results than types 1 or 5 on high-resolution,
  1723.                            low colour output devices such as laser
  1724.                            printers.
  1725.  
  1726.                            Type 20 is a digital halftone; this will produce
  1727.                            the most accurate grays on a laser printer, but
  1728.                            the image won't be as sharp as one produced by
  1729.                            the error-diffusion dithers.  Type 21 is a
  1730.                            dispersed dot ordered dither; it's only
  1731.                            advantage over the error-diffusion algorithms is
  1732.                            speed.
  1733.  
  1734.                            The -d option only has an effect if the number
  1735.                            of colours is being reduced or the image is
  1736.                            being re-mapped to a new palette.
  1737.  
  1738.  
  1739.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-27
  1740.  
  1741.  
  1742.  
  1743.                            Specifying a perturbation adds noise to the
  1744.                            image, which can help break up visible patterns
  1745.                            introduced by dithering.  The parameter
  1746.                            specifies the magnitude of the noise.
  1747.                            Perturbation has no effect on dither types 20
  1748.                            and 21.
  1749.  
  1750.                            Using a serpentine raster can also help to
  1751.                            reduce visible patterns introduced by dithering.
  1752.                            Using a serpentine raster has no effect on
  1753.                            dither types 20 and 21.
  1754.  
  1755.           Examples         Convert the 256 colour file image.gif to a 16
  1756.                            colour PCX file using a uniform palette and no
  1757.                            dithering:
  1758.  
  1759.                                 alchemy image.gif -p -c16 -d0 -u
  1760.  
  1761.                            Convert the true colour image sample.jpg into a
  1762.                            256 colour GIF file called sample.gif, using
  1763.                            Stucki dithering:
  1764.  
  1765.                                 alchemy -g -d2 sample.jpg
  1766.  
  1767.                            Convert the 256 colour image sample.gif into a
  1768.                            one bit black and white PCL file called
  1769.                            sample.pcl, using Jarvis, Judice, and Ninke
  1770.                            dithering, a serpentine raster, and a little
  1771.                            noise:
  1772.  
  1773.                                 alchemy -P -b -c2 -ds3 20 sample.gif
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-28
  1798.  
  1799.  
  1800.  
  1801.           Gamma correction                                               -G
  1802.  
  1803.  
  1804.           Purpose          Specify the gamma of an input, output, or
  1805.                            palette file and/or perform gamma correction.
  1806.  
  1807.           Syntax           -G gammaType gammaValue
  1808.  
  1809.           Parameters       gammaType:
  1810.                                 i:Specify input gamma
  1811.                                 o:Specify output gamma
  1812.                                 p:Specify gamma of palette
  1813.  
  1814.                            gammaValue:
  1815.                                 0.0 to 4.0
  1816.  
  1817.           Comments         To perform gamma correction, Alchemy needs to
  1818.                            know both the input and output gamma.  For some
  1819.                            file formats the gamma is known; if you're
  1820.                            reading a file with known gamma, such as JPEG,
  1821.                            PICT, PCPAINT, or a Targa file with the gamma
  1822.                            field, you don't need to specify the input
  1823.                            gamma.  Likewise, if you're writing a file which
  1824.                            has a fixed gamma you don't need to specify an
  1825.                            output gamma.  Even if reading or writing a file
  1826.                            format which has a known gamma you may override
  1827.                            it by using the -Gi or -Go option.
  1828.  
  1829.                            However, even if both input and output gamma are
  1830.                            known based on the input file and the output
  1831.                            format, you must still enable gamma correction
  1832.                            for any correction to take place; you can do
  1833.                            this with just '-G' (if you had specified input,
  1834.                            output, or palette gamma, this would be
  1835.                            implied).  This is because there are quite a few
  1836.                            images around that have specified or implied
  1837.                            gammas that are wrong, which could cause Alchemy
  1838.                            to make matters worse instead of better.
  1839.  
  1840.                            Typical values for gamma are 1.0 for images from
  1841.                            Macintoshes and 2.2 for images from PCs.
  1842.  
  1843.           Examples         To convert the Mac PICT file test.pic, which has
  1844.                            a gamma of 1.0, to a PCX file for use on a PC
  1845.                            (which should have a gamma of 2.2), use:
  1846.  
  1847.                                 alchemy -p -Gi1.0 -Go2.2 test.pic
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-29
  1856.  
  1857.  
  1858.  
  1859.                            The input gamma could have been omitted, as PICT
  1860.                            files have an implied gamma of 1.0, but it's
  1861.                            best to include it to reduce confusion.
  1862.  
  1863.                            To convert the file image.tga, which has a gamma
  1864.                            of 2.2, to a GIF file for use on a Mac, matching
  1865.                            the palette test.pal which was created with a
  1866.                            gamma of 1.5:
  1867.  
  1868.                                 alchemy image.tga -g -Gi2.2 -Go1.0 -Gp1.5 -
  1869.                                 ftest.pal
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-30
  1914.  
  1915.  
  1916.  
  1917.           Negate                                                         -N
  1918.  
  1919.  
  1920.           Purpose          Changes the image to a negative.
  1921.  
  1922.           Syntax           -N
  1923.  
  1924.           Comments         This is equivalent to a photographic negative.
  1925.                            When used on black and white images black is
  1926.                            changed to white and white is changed to black.
  1927.                            On colour images each of the Red, Green, and
  1928.                            Blue channels are inverted separately (so that
  1929.                            bright blue will become bright yellow).
  1930.  
  1931.           Examples         Negate the file sample.gif, generating a GIF
  1932.                            file called negative.gif:
  1933.  
  1934.                                 alchemy sample.gif -N -g negative
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-31
  1972.  
  1973.  
  1974.  
  1975.           Spiff                                                          -S
  1976.  
  1977.  
  1978.           Purpose          Enhance the image contrast by stretching the
  1979.                            pixel colour values to the full 0 to 255 range.
  1980.  
  1981.           Syntax           -S spiffType
  1982.  
  1983.           Parameter        spiffType:
  1984.                                 a:histogram stretching
  1985.                                 b:histogram linearization
  1986.                            The default is histogram stretching.
  1987.  
  1988.           Comments         This command can be used if the image you are
  1989.                            converting is shifted in brightness or squished
  1990.                            in contrast.  This can happen if you scan or
  1991.                            digitize a very dark or very bright image.
  1992.  
  1993.                            The default type, histogram stretching, simply
  1994.                            insures that the image has pixels which are
  1995.                            distributed over the entire output range (0 to
  1996.                            255).
  1997.  
  1998.                            Histogram linearization insures that the
  1999.                            distribution of pixels over the output range is
  2000.                            linear.
  2001.  
  2002.                            Histogram linearization can produce
  2003.                            significantly better results than histogram
  2004.                            stretching for some images.  Generally you will
  2005.                            want to try both types to see which gives better
  2006.                            results.
  2007.  
  2008.           Limitations      The -S option cannot be used at the same time as
  2009.                            the -b option when converting from a true colour
  2010.                            image.  A work around is to do the operation in
  2011.                            two steps, converting it to black and white
  2012.                            first and then spiffing the resulting image.
  2013.  
  2014.                            Using the spiff option at the same time as the
  2015.                            match palette, -f, or false colour, -F, options
  2016.                            is not allowed.  This is because the spiff
  2017.                            option would be performed before the palette is
  2018.                            changed, which would nullify the effects.  A
  2019.                            work around is to do the matching or false
  2020.                            colouring first, and then spiff the resultant
  2021.                            image.
  2022.  
  2023.           Related options  -b   Black and White
  2024.                            -f   Match palette
  2025.                            -F   False colour image
  2026.  
  2027.  
  2028.  
  2029.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-32
  2030.  
  2031.  
  2032.  
  2033.           Example          Convert the file gloomy.pcx into a PCX file
  2034.                            called better.pcx:
  2035.  
  2036.                                 alchemy gloomy.pcx -S -p better.pcx
  2037.  
  2038.                            Do the same thing using histogram linearization
  2039.                            instead of histogram stretching:
  2040.  
  2041.                                 alchemy gloomy.pcx -Sb -p better.pcx
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-33
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.           Viewing Options (MS-DOS Only)
  2099.           -----------------------------------------------------------------
  2100.  
  2101.  
  2102.           Display hardware Image Alchemy v1.6 supports VESA compatible and
  2103.                            S3 equipped SVGA boards for 15 bit viewing.  In
  2104.                            addition, a scaled 15 bit viewing option has
  2105.                            been added.
  2106.  
  2107.                            There are also two new environment variable
  2108.                            options which affect viewing.  One allows the
  2109.                            disabling of checking for the 8514/A board
  2110.                            (which causes problems with some network adapter
  2111.                            boards) and the other allows you to specify the
  2112.                            maximum resolution that your monitor is capable
  2113.                            of when viewing with a VESA compatible VGA
  2114.                            board; see the section on installing Image
  2115.                            Alchemy earlier in this addendum.
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-34
  2146.  
  2147.  
  2148.  
  2149.           View Image in 15 Bit Mode                                     --v
  2150.  
  2151.  
  2152.           Purpose          View file using 15 bits/pixel mode.  This allows
  2153.                            true colour images to be viewed without
  2154.                            dithering to a uniform palette.
  2155.  
  2156.           Syntax           --v horizontalResolution
  2157.  
  2158.           Parameter        horizontalResolution
  2159.                                 640:Use 640x480 mode
  2160.                                 800:Use 800x600 mode
  2161.                                 1024:Use 1024x768 mode
  2162.                                 1280:Use 1280x1024 mode
  2163.  
  2164.           Comments         Requires either a Tseng 4000 equipped SVGA, an
  2165.                            S3 equipped SVGA board, or a VESA compatible
  2166.                            SVGA board with a Sierra DAC and 1 Megabyte of
  2167.                            memory on the SVGA board.
  2168.  
  2169.                            24 bit images will be dithered to 15 bit when
  2170.                            using this option.  You can turn off dithering
  2171.                            (speeding up the display and slightly reducing
  2172.                            the image quality) by using the -d option.
  2173.  
  2174.           Related options  --V  View scaled image in 15 bit mode
  2175.                            -d   Specify dither type
  2176.  
  2177.           Example          View madonna.tga:
  2178.  
  2179.                                 alchemy madonna.tga --v
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-35
  2204.  
  2205.  
  2206.  
  2207.           View Scaled Image in 15 Bit Mode                              --V
  2208.  
  2209.  
  2210.           Purpose          View image in 15 bit mode while scaling image to
  2211.                            fit on monitor and correcting aspect ratio.
  2212.  
  2213.           Syntax           --V horizontalResolution
  2214.  
  2215.           Parameter        horizontalResolution
  2216.                                 640:Use 640x480 mode
  2217.                                 800:Use 800x600 mode
  2218.                                 1024:Use 1024x768 mode
  2219.                                 1280:Use 1280x1024 mode
  2220.  
  2221.           Comments         Requires either a Tseng 4000 equipped SVGA, an
  2222.                            S3 equipped SVGA board, or a VESA compatible
  2223.                            SVGA board with a Sierra DAC and 1 Megabyte of
  2224.                            memory on the SVGA board.
  2225.  
  2226.                            This command will scale the image and correct
  2227.                            the aspect ratio of the image by removing rows
  2228.                            and/or columns from the image.
  2229.  
  2230.                            Note that this option can also be useful for
  2231.                            displaying images which are not larger than the
  2232.                            screen but which have an aspect ratio different
  2233.                            than the display.
  2234.  
  2235.           Limitations      The same limitations as for scaled 8 bit viewing
  2236.                            apply (see page 7-7 in the User's Manual).
  2237.  
  2238.           Related options  -D   Specify image resolution
  2239.                            --v  View image in 15 bit mode
  2240.  
  2241.           Example          View sample.jpg:
  2242.  
  2243.                                 alchemy sample.jpg --V
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-36
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.           Answers to Frequently Asked Questions
  2270.           -----------------------------------------------------------------
  2271.  
  2272.  
  2273.  
  2274.                   Question How do I get a copy of the current draft JPEG
  2275.                            standard?
  2276.  
  2277.                     Answer The JPEG standard is a ISO/IEC standard
  2278.                            currently in Committee Draft form.
  2279.  
  2280.                            Contact your local ISO/IEC office to get a copy.
  2281.                            The reference numbers are ISO/IEC JTC 1 and /SC
  2282.                            2 N2215; the document number is ISO/IEC CD
  2283.                            10918-1.
  2284.  
  2285.                            In the United States you can contact ANSI at:
  2286.                               ANSI
  2287.                               11 West 42nd St.
  2288.                               New York, NY  10036
  2289.                               (212) 642-4900
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-37
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.           Version History
  2328.           -----------------------------------------------------------------
  2329.  
  2330.  
  2331.           Version 1.6      Released for MS-DOS, 80386 Protected Mode, Sun
  2332.                05/92       SPARC, Interactive UNIX, SCO UNIX, IBM RS/6000,
  2333.                            HP 9000/7xx & 8xx, and Silicon Graphics IRIS.
  2334.  
  2335.                    Format  Added AVHRR support.
  2336.                            Added PDS support.
  2337.                            Added RIX support.
  2338.                            Added SPOT Image support.
  2339.                            Added GOES support.
  2340.                            Added CALS support.
  2341.                            Added Alpha Microsystems BMP support.
  2342.                            Added Dr. Halo CUT support.
  2343.                            Added First Publisher ART support.
  2344.                            Added PictureMaker support.
  2345.                            Added XPM support.
  2346.                            Added IBM Picture Maker support.
  2347.  
  2348.                            Disabled LZW Compression in TIFF pending
  2349.                            resolution of patent issues (and changed default
  2350.                            TIFF compression to PackBits).
  2351.                            Added support for reading tiled TIFF images.
  2352.                            Added support for reading JTIFF images.
  2353.                            Added support for several additional types of
  2354.                            incorrect TIFF files.
  2355.                            Added support for reading type 1, mapped PICT
  2356.                            files.
  2357.                            Added support for reading and writing multi-bit
  2358.                            grayscale and colour GEM files.
  2359.                            Added support for reading 4 bit XWD files.
  2360.                            Added support for an additional type of
  2361.                            incorrect Targa file.
  2362.                            Made PCL reading more robust (including adding
  2363.                            support for landscape files).
  2364.                            Added support for reading old format BMP files.
  2365.                            Added support for Gamma information in Utah RLE
  2366.                            files.
  2367.                            Added default palettes to WPG reading.
  2368.                            Added support for reading 5-5-5 PICT files.
  2369.                            Added compression option to Sun Raster and SGI
  2370.                            files.
  2371.                            Added compression to writing Utah RLE, GEM, and
  2372.                            WPG files.
  2373.                            Added support for writing BMP Icon files and BMP
  2374.                            palette identity files.
  2375.  
  2376.  
  2377.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-38
  2378.  
  2379.  
  2380.  
  2381.                   Display  Added support for 15 bit VESA compatible SVGA
  2382.                  (MS-DOS)  boards.
  2383.                            Added support for S3 equipped 15 bit SVGA
  2384.                            boards.
  2385.                            Added scaled 15 bit view option.
  2386.                            Added environment variables to indicate monitor
  2387.                            resolution.
  2388.  
  2389.                      Misc  Decreased memory usage for MS-DOS version
  2390.                            (allowing the conversion of larger images).
  2391.                            Added 5 new dithering types.
  2392.                            Added histogram equalization option to spiff.
  2393.                            Added negative flag.
  2394.                            Added gamma correction.
  2395.  
  2396.                Bugs fixed  Writing to directories not on the current disk
  2397.                            (MS-DOS).
  2398.                            Reading certain 1 bit PCX files.
  2399.                            Reading certain PICT files.
  2400.                            Checking for Targa files.
  2401.                            Viewing on certain VESA boards (MS-DOS).
  2402.                            Reading certain 8 bit ILBM files.
  2403.                            Scaled viewing of very skinny images (MS-DOS).
  2404.                            Histogram equalization (non MS-DOS).
  2405.                            Writing WPG files.
  2406.                            Writing 1 bit PBM files.
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-39